home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / dizit11.zip / DIZIT.DOC < prev    next >
Text File  |  1992-12-19  |  11KB  |  289 lines
  1.                                 DizIt v1.1
  2.                         
  3.                        
  4.                              For PCBoard v14.5a
  5.  
  6.  
  7.  
  8.                                     By
  9.  
  10.                               Copyright 1992
  11.                                 Robert Neal
  12.                                 317 Hickory
  13.                            Romeoville, IL  60441
  14.  
  15.  
  16.  
  17.                                 Support BBS:
  18.                          Corporate Headquarters BBS
  19.                   Node #1: (815) 886-3233  14400 v.32bis
  20.                   Node #2: (815) 886-9381  14400 v.32bis
  21.  
  22.  
  23.  
  24.  
  25.                             PROGRAM INFORMATION
  26.                             ===================
  27.  
  28. As a sysop, you've probably downloaded hundreds of files to add to your
  29. board. You've probably used the local upload option in PCBoard to add
  30. these files to your system, or you've used PCBFiler to read the new
  31. files and manually typed in each file description. But with many files
  32. now including their own description file, FILE_ID.DIZ and DESC.SDI,
  33. wouldn't it be nice to have a program do all the work for you?
  34.  
  35. DizIt is a utility written for PCBoard v14.5a to do just that. DizIt was
  36. written to aid sysops in adding files which contain FILE_ID.DIZ or
  37. DESC.SDI into their upload directory from the command line. The entire
  38. process is simple to do, even easier than using the "local upload"
  39. option of PCBoard.
  40.  
  41. DizIt may be called to process files one at a time by entering
  42. DIZONE.BAT, or using the batch file DIZALL.BAT included with the
  43. program, you can automatically process an entire directory of files in
  44. a matter of seconds. With DIZALL, DizIt will check each file in the
  45. directory to see if FILE_ID.DIZ or DESC.SDI. If found, the file is
  46. processed. If not found DizIt will do no further processing of the file
  47. except for moving the file to the holding directory you've indicated.
  48. This allows you to place all your files you want to add in the directory
  49. and let DizIt search for those that can be automatically added to your
  50. PCB File directory listing.
  51.  
  52. Currently, DizIt is written to process ZIP and ARJ archived files.
  53. Based on my experiences, the majority of files being distributed are in
  54. these two formats. If there is a demand, I will look to include additional
  55. formats in a future version.
  56.  
  57.  
  58. My thanks to Marc Medow of Midas Touch BBS for taking the time to beta
  59. test this program. Having someone else look over your work helps get the
  60. cobwebs out.
  61.  
  62.  
  63.  
  64.                         PROGRAM INSTALLATION/OPERATION
  65.                         ==============================
  66.  
  67. INSTALL
  68. -------------------------
  69.  
  70. Place the DIZIT files into a directory in your path. You may place DIZIT
  71. in it's own directory if you so choose, but you must be sure to properly
  72. configure the batch files to make the call to the proper directory when
  73. running DIZIT.
  74.  
  75. Ensure that the appropriate archiving programs are available in your
  76. directory path. For ZIP files, you'll need PKZIP.EXE and PKUNZIP.EXE.
  77. For ARJ files you'll need ARJ.EXE. DIZIT makes a call to these programs
  78. to extract the description files as well as importing your BBS comment
  79. file.
  80.  
  81.  
  82.  
  83.  
  84.  
  85. CREATE CONFIGURATION FILE
  86. --------------------------
  87.  
  88. Edit DizIt configuration file, DizIt.CFG. Use your favorite text
  89. editor to edit this file.
  90.  
  91. The items in the configuration file are as follows, do not include the
  92. line number references. Refer to detailed explanation below for each
  93. line:
  94.  
  95.         DizIt.CFG
  96.         --------------------------
  97. Line 1: Corporate Headquarters BBS
  98. Line 2: 0
  99. Line 3: G:\WORK
  100. Line 4: C:\UPLOAD
  101. Line 5: C:\HOLD
  102. Line 6: D:\PCB\MAIN\UPLD
  103. Line 7: D:\BBS.CMT
  104.  
  105.  
  106.  
  107. Line 1: BBS Name
  108.  
  109. Line 2: Registration number, leave as 0 if unregistered.
  110.  
  111. Line 3: Drive/path to be used for temporary work area. A RAM disk, if
  112.         available, is recommended. Ensure that this directory exists
  113.         before using DizIt. Do not include the trailing "\" at the
  114.         end of the directory name.
  115.  
  116. Line 4: Drive/path of where files are to be moved to once they are
  117.         processed. This could be your public upload directory, private
  118.         directory or any other directory you choose. Again, ensure that
  119.         this directory exists before using DizIt. Do not include the
  120.         trailing "\" at the end of the directory name.
  121.  
  122. Line 5: Drive/path of where files should be moved if either FILE_ID.DIZ
  123.         or DESC.SDI is not found. Enter "NONE" on this line if you want
  124.         DIZIT to keep the files in the directory they are currently
  125.         located.
  126.  
  127.  
  128. Line 6: Full path/filename of the file to which is to be updated with
  129.         the files imported. Typically this will be your public upload
  130.         directory, but you may want to instead move the files to your
  131.         private upload directory so that you may preview the files
  132.         before making them public. This file should relate to the
  133.         directory choosen above.
  134.  
  135. Line 7: Full path/filename of a comment file you want to have added to
  136.         the ZIP file. Typically, this may be your "BBS AD" comment.
  137.  
  138.  
  139.  
  140. EDIT BATCH FILES
  141. -----------------------
  142.  
  143. DIZIT comes with two batch files, one for processing a single file
  144. (DIZONE.BAT) and one for processing all files in one batch file
  145. (DIZALL.BAT). For easiest set-up, place these two files in a directory
  146. within your DOS PATH.
  147.  
  148. Edit the file DIZALL.BAT. If this batch file is missing, here is the
  149. batch file:
  150.  
  151. Line 1:        REM
  152. Line 2:        REM - Will process all ZIP files
  153. Line 3:        REM
  154. Line 4:        C:
  155. Line 5:        cd \DIZTEMP
  156. Line 6:        FOR %%1 IN (*.*) DO C:\PCB\DizIt C:\PCB\DIZIT.CFG %%1
  157.  
  158.  
  159. Line 1 to 3 may be deleted if desired - only included for commenting
  160. information.
  161.  
  162. Line 4 changes to the drive where DIZIT resides.
  163.  
  164. Line 5 changes to the directory where the files to be processed are
  165. stored.
  166.  
  167. Line 6 is the heart of the batch file. It will automatically process
  168. each file in the directory indicated on line 5 above. Be sure to edit
  169. this line to properly reflect which directory DIZIT.EXE and DIZIT.CFG
  170. are to be found.
  171.  
  172.  
  173. *** Follow the same format for editing the DIZONE.BAT file.
  174.  
  175.  
  176.  
  177. PROGRAM OPERATION
  178. ------------------
  179.  
  180. Move all files to be processed into the directory indicated on line 5 in
  181. your DIZALL.BAT file.
  182.  
  183.  
  184.  
  185. You may call the program one file at a time by issuing the command:
  186.  
  187.         DIZONE filename.ZIP
  188.  
  189. But the preferred method should be to batch process all files using the
  190. command:
  191.  
  192.         DIZALL
  193.  
  194.  
  195. Once the prorgam is started, it will check to make sure the file exists
  196. in the directory. Once verified, DizIt will, if instructed, add the ZIP
  197. COMMENT specified on line 7 of the DizIt.CFG file to the ZIP file.
  198.  
  199. DizIt will then check the ZIP file to see if the FILE_ID.DIZ or
  200. DESC.SDI file exists in the ZIP file. If not found, DizIt will skip the
  201. file -- it will not place the filename in the PCBoard file directory
  202. listing.
  203.  
  204. If FILE_ID.DIZ or DESC.SDI is found, DizIt will extract the file to
  205. your temporary work directory and then begin to add the file to the end
  206. of your PCBoard file directory indicated in the configuration file.
  207. Unlike other similar programs, DizIt will update your PCBoard file
  208. listing with the file size and the current date of the upload, no
  209. further processing of the PCBoard file directory list is required.
  210.  
  211. Once DizIt has imported the file and description into your PCBoard file
  212. directory list, DizIt will move the file from the current directory to
  213. the directory specified in line 4 in the configuration file.
  214.  
  215.  
  216.  
  217.                               REGISTRATION
  218.                               ============
  219.  
  220. DizIt is released as user support software (aka SHAREWARE). I don't
  221. expect you to register the program if you don't like it or if it doesn't
  222. meet your needs (just stop using it). But if you continue to use DizIt
  223. after a reasonable evaluation period of up to 30 days, you are required
  224. to make payment for the program or stop using it.
  225.  
  226. DizIt is NOT crippled in any way other than a marker "->DizIt" will be
  227. added to the last line of the file description field. This function has
  228. been added as an incentive to register the program. Once you have
  229. registered the program, the marker will no longer added to the imported
  230. description.
  231.  
  232. Registration is only $10 and will include unlimited free upgrades and
  233. support via my BBS.
  234.  
  235. Please use the form REGISTER.FRM included with the program to register
  236. DizIt. If this file is missing, send a check for $10 (US funds) to:
  237.  
  238.         Robert Neal
  239.         317 Hickory
  240.         Romeoville, IL  60441
  241.  
  242. Please include your BBS name as this information will be used to create
  243. your unique registration key file. You may receive your registration
  244. file via my support BBS (but please be sure you have an account
  245. established on my BBS so that I can leave this information in a private
  246. message to you) or via the US Mail. Please indicate your preference.
  247.  
  248. Keep your eye open for other utility programs from me written for
  249. PCBoard. Several programs are now in the works and should be released
  250. soon. Also, look for my door programs, Card Sharks and Links Golf
  251. (available on my BBS as well), I think your users will enjoy playing
  252. them. See the file OTHER.TXT for a listing of all my currently available
  253. programs.
  254.  
  255.  
  256.  
  257.  
  258.                                   SUPPORT
  259.                             ===================
  260.  
  261. If you have any questions, comments, problems, suggestions for enhancements,
  262. etc., I may be reached at my support BBS or by mail. In addition, you may send
  263. a message to me on the RIME conferences to my BBS "CHQBBS", I regularly
  264. monitor the messages in the Sysop, BBS and PCBoard Support conferences. I can
  265. also be reached via Prodigy, PNSP01A.
  266.  
  267.  
  268.  
  269.                              LEGAL INFORMATION
  270.                       ===============================
  271.  
  272. This program is provided on an "AS IS" basis.  No warranty of any kind is
  273. expressed or implied.  YOU USE THIS PROGRAM AT YOUR OWN RISK.  I take no
  274. responsibility for any damage caused directly or indirectly from the use or
  275. the inability to use this program.
  276.  
  277.  
  278.  
  279. VERSION HISTORY:
  280.  
  281.         v1.0 - Initial release
  282.         v1.1 - Fixed bug where if NONE was selected as the directory to
  283.                  move files to, DIZIT would rename file to NONE.
  284.                If DIZIT processed a file at the same time that the
  285.                  PCBoard upload directory was being browsed on a 2nd
  286.                  node, DIZIT would return error. Revised file handling
  287.                  so that this no longer occurs - DIZIT updates file
  288.                  without an error.
  289.